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An  Overview  of  JSAF’s  Environmental  Capabilities  and  Data 

1.  Introduction  and  Overview  of  JSAF 

The  purpose  of  this  report  is  to  provide  an  overview  of  JSAF  with  a  focus  on 
understanding  the  environmental  capabilities,  constraints,  and  datasets  used  in  JSAF. 
This  first  section  describes  JSAF  and  how  it  is  typically  used  in  training.  The  second 
section  briefly  describes  the  environmental  capabilities  and  datasets  used  for  the 
atmosphere,  ocean,  and  underwater  acoustics.  In  the  last  section,  a  list  of  references 
which  point  to  more  comprehensive  and  in-depth  detail  on  JSAF  is  provided. 

JSAF  stands  for  Joint  Semi-Automated  Forces  and  is  maintained  by  the  Naval 
Warfare  Development  Command  (NWDC).  JSAF  is  a  simulation  system  designed  for 
training  and  experimentation.  It  runs  in  the  Linux  operating  system,  either  as  a 
standalone  system  or  in  a  networked  environment  with  several  computers  taking  part  in  a 
simulation.  The  user  interface,  known  as  the  Plan  View  Display  or  PVD  (Figure  1), 
provides  tools  for  an  operator  to  create,  monitor  and  run  a  training  scenario.  The  user 
may  select  any  number  of  air,  sea,  land,  and  underwater  vehicles,  and  specify  the  country 
and  exact  model  or  name  of  the  vehicle,  e.g.  an  Iranian  AUV  or  the  USS  Eisenhower.  In 
addition  to  vehicles,  JSAF  includes  people,  dolphins  and  other  life,  and  structures  such  as 
buildings.  Complicated  physical  and  performance  behaviors  are  associated  with  each 
vehicle.  A  ship’s  parameters,  for  example,  would  include  turning  radius  at  a  given  speed, 
fuel  consumption,  and  which  radars  and  sensors  and  communications  systems  are 
available  on  that  particular  ship.  The  user  can  activate  and  configure  jamming  systems 
for  those  vehicles  that  have  an  Electronic  Warfare  (EW)  capability,  or  sonar  systems, 
Electronic  Surveillance  Measures  (ESM),  radar,  etc.  The  user  can  set  up  tasks  or 
missions  for  each  unit,  which  are  typically  composed  of  move,  shoot,  coordinate,  and 
react.  Once  the  scenario  begins,  the  display  will  show  not  only  the  vehicles  moving  in  the 
simulation,  but  can  also  display  sensor  contacts  such  as  a  line  of  bearing,  detections  and 
tracks. 


JSAF  enables  what  are  known  as  “constructive  simulations”  '.  These  are 
simulations  that  involve  the  entire  battle  space  with  simulated  ships,  aircraft  and  other 
units  controlled  by  simulation  operators,  who  act  behind  the  scenes  to  stimulate  the 
people  being  trained,  without  directing  the  outcome  of  the  event.  As  individuals  in  each 
unit  react  to  contacts  or  new  information  and  make  a  decision,  those  decisions  are 
propagated  to  other  units  in  the  simulation  and  across  the  entire  integrated  joint 
warfighting  team.  These  training  simulations  may  require  up  to  six  months  to  prepare. 
Additional  background  on  NCAMS  (Navy  Center  for  Advanced  Modeling  and 
Simulation)  at  NWDC  is  available  in  CFIIPS,  the  Navy’s  information  technology 
magazine  at  http://www.donc  io.navy.mil/chips/ArticlcDctails.aspx?  I  D=2297'. 
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Figure  1.  The  Plan  View  Display  (PVD)  in  JSAF. 


2.  Environmental  Data 

JSAF  can  be  run  either  with  uniform  and  constant  environmental  conditions  or 
spatially  and  temporally  varying  environmental  conditions.  In  the  standalone  mode,  no 
time-varying  data  is  available.  The  default  conditions  are  constant  in  time  and  uniform  in 
space  and  are  given  in  Table  1  below2. 


Environmental  Factor 

Default  Value 

sun’s  position 

noon 

wind  speed 

0  mph 

wind  direction 

east  to  west 

cloud  cover 

10% 

precipitation 

none 

visibility 

infinite,  subject  to  terrain 

Table  1.  Default  environmental  conditions,  from  Ref.  2. 
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The  values  of  these  environmental  parameters  can  be  changed  via  the  environment  editor 
icon  EUl  in  the  Tools  menu  as  shown  in  Figure  2. 
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Figure  2.  The  JSAF  environmental  editor  showing  the  default  weather  settings. 


The  interface  for  variables  relevant  to  EM  propagation  and  ducting  are  set  through 
the  Misc  tab  in  the  weather  editor  (Figure  3): 


Figure  3.  The  Environment  Editor  to  control  EM  propagation  in  JSAF. 


Similarly,  Figure  4  shows  the  interface  for  setting  up  ocean  conditions,  set  by  clicking  on 
the  Ocean  Parameters  editor  icon 
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Figure  4.  The  Ocean  Parameters  editor  in  JSAF. 

In  this  editor,  tide  level,  sea  state,  and  wave  characteristics  such  as  frequencies  of 
long  waves,  significant  wave  height,  direction,  and  period  can  be  set.  Surface 
temperature  and  salinity  and  deep  current  speed  and  direction  can  also  be  set. 

For  time-dependent  environmental  conditions,  JSAF  ingests  weather  and  ocean 
data  through  the  Environmental  Data  Cube  Support  System  (EDCSS)  plug-in,  supported 
by  CNMOC3.  It  is  also  possible  to  run  without  the  EDCSS  Distributor,  and  just  run  with 
weather  data  locally  on  the  user’s  hard  drive.  Details  and  instructions  are  provided  in  the 
Joint  Simulation  Bus  (JBUS)  User’s  Guide*. 

The  data  available  are  either  monthly  climatologies,  historical  data  from  a  specific 
date  or  the  current  day’s  data  (not  available  as  of  January  2012).  As  depicted  in  Figure  5, 
climatologies  are  obtained  from  OAML  (Oceanographic  and  Atmospheric  Master 
Library),  historical  data  is  identified  and  extracted  by  CNMOC  staff,  or  current 
conditions  are  provided  by  FNMOC  (although  this  real-time  capability  is  not  currently 
available).  Training  events  using  JSAF  typically  use  historical  data  from  a  period  having 
the  properties  desired  for  the  operational  problem.  The  CNMOC  METOC  staff  prepare 
event  data  using  their  Environmental  Scenario  Generator  (ESG).  The  ESG  queries  the 
library,  extracts  the  data,  and  converts  it  to  the  format  needed.  Most  training  events  get 
acoustic  environment  data,  visual  sensor  environment  data  and  radar  evaporative  duct  and 
surface  duct  data.  The  data  is  prepared  in  2D  and  3D  gridded  fonn  for  JSAF  and  also  in 
the  forms  needed  by  the  tactical  decision  aids  such  as  PC-IMAT.  The  data  prepared  may 

o 

also  include  forecast  maps,  forecast  messages  etc.  for  use  by  the  trainees.  In  addition, 
as  shown  in  Figure  5,  the  EDCSS  can  produce  synthetic  observations,  such  as 
bathythermograph  (BT)  data,  or  synthetic  imagery  to  be  used  in  the  training  event. 
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Figure  5.  Schematic  from  Reference  5. 


For  the  historical  option,  the  following  data  is  used  (from  Ref  9): 

Ocean  Sound  Speed  3-D  Grids 

•  Temperature 

•  Salinity 

Surface  Weather  2-D  Grids  (at  10  m) 

•  Air  Temperature 

•  Surface  Pressure 

•  Relative  Humidity 

•  Surface  Winds  (U/V  Components) 

•  Precipitation  Rate  and  Type 

•  Visibility  or  Visual  Extinction  Coefficients 

•  Radar  Duct  Info  (evap  duct  height,  surface  duct  height,  k  factor,  surface 
refractivity) 
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Cloud  and  Fog  cover  (ceiling,  max  height,  %  cover,  type) 


Sea  Conditions  2-D  Grids 

•  Sea  State  Category  or  Significant  Wave  Height 

•  Surface  Current  (U/V  components) 

Typical  grid  spacings  for  the  historic  data  are: 

•  1/8  degree  for  sound  speed  data  (NCOM) 

•  1/2  degree  for  atmospheric  data  (COAMPS) 

•  1/5  degree  for  sea  surface  data  (WW3) 

While  JSAF  is  capable  of  using  two-dimensional  time  varying  data  in 
electromagnetic  propagation  predictions,  only  the  ocean  data  has  been  used  in  this  way  in 
the  past,  to  make  acoustic  propagation  loss  predictions  for  use  by  the  sonar  sensors5. 
According  to  Reference  5,  “Prior  to  an  event,  the  client,  operations  and  the  local 
meteorology  office  review  the  training  objectives,  identify  weather  conditions  appropriate 
to  those  objectives  and  search  the  available  products  for  a  period  of  data  that  has  suitable 
weather  conditions.  The  meteorology  staff  extracts  this  data  and  makes  it  available, 
either  directly  from  EDCSS  or  as  data  sets  in  a  form  that  can  be  published  by  the  JBUS 
environmental  data  distributor.”  Note:  “weather”  includes  both  ocean  and  atmospheric 
conditions.  For  most  training  events,  locally  served  file  data  is  used  rather  than  querying 
and  using  the  data  from  web  services. 

The  temporal  sampling  currently  used  changes  every  four  hours,  which  is  an 
appropriate  time  scale  for  ocean  acoustic  applications.  However,  for  the  atmosphere, 
Hamby  (Ref  5)  points  out  that  the  interval  for  meteorological  sampling  should  be  shorter 
to  capture  more  rapidly  changing  conditions,  or  have  non-uniform  sampling  in  time,  with 
more  frequent  sampling  when  needed,  and  less  frequent  say  during  the  night  time  when 
conditions  are  changing  more  slowly. 

For  the  ocean  climatology,  the  data  is  extracted  from  the  GDEM-V  3.0-050 
(General  Digital  Environmental  Model  -Variable  resolution)  database,  which  provides 
bottom  depth,  ocean  temperature  and  salinity  profile  data.  For  atmospheric  variables,  the 
data  sources  are  not  stated,  but  the  Surface  Marine  Gridded  Climatology  (SMGC)  is  used 
for  climatology  and  COAMPS  output  is  used  for  historical  data.  The  following  table  is 
from  the  JBUS  EDCSS  SDD  documentation6  and  covers  all  the  environmental  data  used 
in  the  Navy  Continuous  Training  Environment  (NCTE)  -  these  are  known  as  BOM  (Base 
Object  Model). 


Class 

Attribute  Name 

Data  Type 

Cardinality 

Units 

Cloud  Layer  GDC 

EAC  Cloud  Base  Height 

Gridded  Scalar  Field  2D 

1 

Meters 

EAC  Cloud  Cover  Fraction  Total 

Gridded  Scalar  Field  2D 

1 

Dimensionless 

EAC  Cloud  Sky  Cover  Type 

Gridded  Enumerated  Field  2D 

1 

N/A 

EAC  Cloud  Thickness 

Gridded  Scalar  Field  2D 

1 

Meters 

6 


EAC  Spatial  Geodetic  Latitude 

Horizontal  Axis 

1 

N/A 

EAC  Spatial  Geodetic  Longitude 

Horizontal  Axis 

1 

N/A 

Origin  Latitiude 

Double 

1 

Degrees 

OriginLongitude 

Double 

1 

Degrees 

Fog  GDC 

EAC  Fog  Cover 

Gridded  Scalar  Field  2D 

1 

Dimensionless 

EAC  Fog  Extinction  Coefficient 

Gridded  Scalar  Field  2D 

1 

1 /meter 

EAC  Fog  Present 

Gridded  Scalar  Field  2D 

1 

0.0  or  1.0 

EAC  Fog  Thickness 

Gridded  Scalar  Field  2D 

1 

Meters 

Radar  Duct  GDC 

EAC  Evaporative  Duct  Altitude 

Gridded  Scalar  Field  2D 

1 

Meters 

EAC  Evaporative  Duct  Index 

Gridded  Scalar  Field  2D 

1 

Dimensionless 

EAC  Evaporative  Duct  Strength 

Gridded  Enumerated  Field  2D 

1 

Dimensionless 

EAC  Surface  EM  Prop  Duct  Altitude 

Gridded  Scalar  Field  2D 

1 

Meters 

EAC  Surface  EM  Prop  Duct  Strength 

Gridded  Enumerated  Field  2D 

1 

Dimensionless 

Surface  Haze 

EAC  Obscurant  Type 

Gridded  Enumerated  Field  2D 

1 

N/A 

GDC 

Extinction  Coefficient  Far  IR 

Gridded  Scalar  Field  2D 

1 

1 /meter 

Extinction  Coefficient  Mid  IR 

Gridded  Scalar  Field  2D 

1 

1 /meter 

Extinction  Coefficient  Near  IR 

Gridded  Scalar  Field  2D 

1 

1 /meter 

Extinction  Coefficient  Visible 

Gridded  Scalar  Field  2D 

1 

1 /meter 

Reference  Height 

Double 

1 

Meters 

Surface 

EAC  Precipitation  Rate 

Gridded  Scalar  Field  2D 

1 

Mm/hr 

Precipitation 

GDC 

EAC  Precipitation  Type 

GriddedEnumeratedF  ield_2D 

1 

N/A 

Surface  Weather 

EAC  Air  Temperature 

Gridded  Scalar  Field  2D 

1 

Degrees  Celsius 

GDC 

EAC  Atm  Pressure 

Gridded  Scalar  Field  2D 

1 

Millibars 

EAC  Blowing  Sand 

Gridded  Enumerated  Field  2D 

1 

N/A 

EAC  Blowing  Snow 

Gridded  Enumerated  Field  2D 

1 

N/A 

EAC  Dewpoint  Depression 

Gridded  Scalar  Field  2D 

1 

Degrees  Celsius 

EAC  Relative  Humidity 

Gridded  Scalar  Field  2D 

1 

Percent 

EAC  Wind  Speed  U  Component 

Gridded  Scalar  Field  2D 

1 

Meters/sec 

EAC  Wind  Speed  V  Component 

Gridded  Scalar  Field  2D 

1 

Meters/sec 

Reference  Height 

Double 

1 

Meters 

Class 

Attribute  Name 

Data  Type 

Cardinality 

Units 

Ocean  Surface 

EAC  Current  U  Ocean 

Gridded  Scalar  Field  2D 

1 

Meters/sec 

Layer  GDC 

EAC  Current  V  Ocean 

Gridded  Scalar  Field  2D 

1 

Meters/sec 

EAC  Tide  Level 

Gridded  Scalar  Field  2D 

1 

Meters 

Ocean  Wave 

EAC  Sea  State  Category 

Gridded  Enumerated  Field  2D 

1 

N/A 

Spectrum  GDC 

EAC  Wave  Direction  Primary 

GriddedScalarF  ield_2D 

1 

Degrees 

Heading 

EAC  Wave  Direction  Secondary 

GriddedScalarF  ield_2D 

1 

Degrees 

Heading 

EAC_Wave  Direction_SwellJVIean 

Gridded_Scalar_F  ield_2D 

1 

Degrees 

Heading 

EAC  Wave  Direction  Wind  Induced  Mean 

Gridded_Scalar_F  ield_2D 

1 

Degrees 

Heading 

EAC  Wave  Height  Maximum 

Gridded  Scalar  Field  2D 

1 

Meters 

EAC  Wave  Height  Significant 

Gridded  Scalar  Field  2D 

1 

Meters 

EAC  Wave  Height  Swell  Significant 

Gridded  Scalar  Field  2D 

1 

Meters 

EAC  Wave  Height  Wind  Induced  Significant 

Gridded  Scalar  Field  2D 

1 

Meters 

EAC  Wave  Period  Primary  Mean 

Gridded  Scalar  Field  2D 

1 

Seconds 

EAC  Wave  Period  Secondary  Mean 

Gridded  Scalar  Field  2D 

1 

Seconds 

EAC  Wave  Period  Swell  Mean 

Gridded  Scalar  Field  2D 

1 

Seconds 

EAC  Wave  Period  Wind  Induced  Mean 

Gridded  Scalar  F ield  2D 

1 

Seconds 

Class 

Attribute  Name 

Data  Type 

Cardinality 

Units 

Ocean  Volume  GDC 

EAC  Current  U 

Gridded  Scalar  Field  3D 

1 

Meters/sec 

EAC  Current  V 

Gridded  Scalar  Field  3D 

1 

Meters/sec 

EAC  Current  W 

Gridded  Scalar  Field  3D 

1 

Meters/sec 

EAC  Salinity 

Gridded_Scalar_F  ield_3D 

1 

Parts  per 

Thousand 

EAC  Sea  Temperature 

Gridded_Scalar_F  ield_3D 

1 

Degrees 
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EAC  Sound  Speed  Water 

Gridded  Scalar  Field  3D 

1 

Celsius 

Meters/sec 

EAC  Spatial  Elevation 

Vertical  Axis 

1 

N/A 

EAC  Spatial  Geodetic  Latitude 

Horizontal  Axis 

1 

N/A 

EAC  Spatial  Geodetic  Longitude 

Horizontal  Axis 

1 

N/A 

Origin  Elevation 

Double 

1 

Meters 

OriginLatitude 

Double 

1 

Degrees 

OriginLongitude 

Double 

1 

Degrees 

Table  2.  Environmental  variables  and  units  that 

are  provided  by  the  EDCSS 

into  JSAF, 

from 

Environmental  Data  Cube  Support  System  (EDCSS)  Plugin  for  JBUS  Software  Design  Description  (SDD)6. 

The  Acoustic  Transmission  Loss  Server  (ATLOS)  provides  a  conduit  between  the 
environmental  system,  such  as  the  EDCSS,  and  sonar  systems  on  the  various  vehicles3. 
The  JSAF  sonar  models  determine  the  acoustic  source  and  passive  receiver  locations  and 
depths  and  then  send  a  transmission  loss  request  to  ATLOS.  The  transmission  loss  is 
calculated  based  on  a  new  range-dependent  broadband  underwater  acoustic  propagation 
model  called  FeyRay,  a  fast  2-D  Gaussian  ray  model.  The  environmental  data  are 
retrieved  from  the  EDCSS  data  server  via  the  JBUS  (Joint  Simulation  Bus).  The  data 
include  ocean  temperature  and  salinity  profdes,  and  surface  conditions,  bottom  depth  and 
bottom  type  which  are  obtained  from  static  JSAF  terrain  databases.  Typically  the 
Estuarine  and  Coastal  Ocean  Model  (ECOM),  a  variant  of  the  Princeton  Ocean  Model 
(POM),  is  used  for  shallow  water  areas,  and  the  Modular  Ocean  Data  Assimilation 
System  (MODAS)  for  deeper  water.  Inputs  to  the  FeyRay  model  are  (1)  sound  speed 
profiles  along  a  great  circle  path  from  the  source  to  the  receiver;  (2)  bottom  bathymetry 
along  the  path;  (3)  surface  wind  speed  along  the  path;  and  (4)  the  bottom  type  along  the 
path.  The  data  are  site-specific  and  are  updated  during  the  simulation  to  include  diurnal 
and  longer  temporal  effects3. 


3  References  and  Links 

More  detailed  and  comprehensive  documentation  of  all  the  features  in  JSAF  are  available  (although  the 
site  is  password-protected)  at 

http://confluence.nwdc.hpc.mil/display/JUG/Documentation  and  in  the  User  Guides  directory  once  the 
program  is  installed. 

1.  Navy  Center  for  Advanced  Modeling  and  Simulation,  in  CHIPS:  The  Department  of  the  Navy’s 
Information  Technology  Magazine.  April  -June  2011. 

http://www.doncio.naw.  mil/chips/ArticleDetails.aspx?ID=2297 

2.  Joint  Semi-Automated  Forces  (JSAF)  System  User’s  Guide.  Plan  View  Display  (PVD)  Volume  1  - 
Introduction  and  Basic  Controls.  Navy  Warfare  Development  Command  for  V4.5.2.  March  27,  2012. 
http://confluence.nwdc.hpc.mil/download/attachments/21859493/JSAF  Users  Guide  Voll  PVD  B452.pd 

f 

3.  Joint  Semi-Automated  Forces  (JSAF)  Simulation  Description.  Created  by  Navy  Warfare  Development 
Command,  3  May  2012. 

http://confluence.nwdc.hpc.mil/download/attachments/1278097/JSAF  System  Description.pdf 

4.  Joint  Simulation  Bus  (JBUS)  Users  Guide,  Wavy  Warfare  Development  Command.  4  May  2012. 
http://confluence.nwdc.hpc.mil/download/attachments/21859493/JBUS  Users  Guide.pdf 
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5.  JSAF  Time  Dependent  Weather  -  NPS  Software  Development  Collaboration: 
http://confluence.nwdc.  hpc.mil/display/NPS/JSAF+Time+Dependent+Weather 

6.  Environmental  Data  Cube  Support  System  (EDCSS)  Plugin  for  JBUS  Software  Design  Description 
(SDD).  Navy  Warfare  Development  Command,  Newport,  RI.  January  2010. 
http://confluence.nwdc. hpc.miEdownload/attachments/7865377/JBUS  EDCSS  SDD.doc 

7.  Environmental  Data  Publication  for  NCTE  Integration  Testing.  Navy  Warfare  Development  Command, 
7  May  2012. 

http://confluence.nwdc.  hpc.miEdownload/attachments/7865377/Environment+Data+Publication.pdf 

8.  Summary  of  Weather  in  JSAF.  April  20,  2012. 

http://confluence.nwdc. hpc.miEdisplav/NPS/Summary+of+Weather+in+JSAF 

9.  Meteorology  and  Oceanography  (METOC).  November  11,  2010. 

http://confluence.nwdc. hpc.miEdisplav/BL4ARCH/Meteorology+and+Oceanographv+%28METOC%29 
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